home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / UTIL / Audio Strip GH 1.3.3.sit / Audio Strip GH 1.3.3 / Read Me -- Audio Strip GH < prev    next >
Text File  |  1996-07-06  |  15KB  |  167 lines
  1.                                                 Generally Helpful Software presents:        
  2.                                                                                                     Audio Strip GH v. 1.3.3
  3.                                                                                                                                                                     by Glenn R. Howes
  4.                                                                                                                                            grhowes@kagi.com
  5.                                                                                                                              7/5/96
  6. Description:
  7. Audio Strip GH is a set of Control Strip modules for Macintosh which facilitate the playing of audio CDs through an attached CD ROM player. You, the user, can build your own personalized CD controller with the buttons you want,and no more waiting for a stand-alone application to launch, the controller is always right in front, with its buttons available and it's display information visible.
  8.  
  9. Requirements:
  10. Appleﾕs Control Strip Control Panel, Ammon Skidmore's Extensions Strip, Mice & Men's Desktop Strip or any one of a number of Control Strip compatible pallete launching type utilities must be installed. As of version 1.3, Control Strip now works with desktop Macs.
  11.  
  12. An attached CD-ROM drive whose driver mimics the functionality of a genuine Apple CD ROM drive, or better yet is an actual Apple CD ROM is needed. If the drive is an external model, it should have speakers attached.
  13.  
  14. Japanese users should get the version localized to that country. Look around for it; if I could read Japanese, I could tell you if Christopher Li has done a good job translating the modules and documentation.
  15.  
  16. Money Matters:
  17. Audio Strip GH is divided into two parts: free, fully functional modules which emulate about half the features of a CD controller; and encryption-ware modules which emulate the other half. I hope that you find the free modules to be so satisfying that you canﾕt wait to send me money for the encryption-ware modules. 
  18.  
  19. The encryption-ware modules are stored in a self-extracting, encrypted archive named ﾒPayware Modules $10 USA.seaﾓ, which should be part of the Audio Strip package. In order for you to get the modules out of this archive, you will have to enter a password. The easiest way use the Register program that comes with this package; fill out the form; choose a method of payment; pay your registration fee; and I will send you the password. If you give a valid, Internet reachable email address I will email you the password saving both time and money.
  20.  
  21. Please do not redistribute either the password or the unencrypted modules. Considering the time and craftsmanship I put into these modules, $10 is not a rip off; they are of the finest commercial quality.
  22.  
  23. Installation:
  24. Drag the icons for the modules you want to use into the ﾒControl Strip Modulesﾓ folder inside your ﾒSystem Folderﾓ and restart. Of the free modules, I recommend you install CD Omni GH, CD Volume GH and maybe CD Eject GH. Of the encrypted modules, I especially recommend CD Omni GH 2. Pick and choose from the remaining modules. CD Pause GH, CD Stop GH and CD Play GH are mainly for users who don't want to use the Omni module because if it is slowing down their systems by periodically (2 second intervals) enquiring into the state of the drive; on my system, this slowdown is negligible, so I use the more powerful Omni module.
  25.  
  26. If you have more than one CD ROM drive, and who doesnﾕt these days, you can make multiple copies of the modules and set them to control the different drives.
  27.  
  28. If you are using an Apple brand drive, make sure to use an up to date driver. You can download the most current version as of this writing is at: <ftp://ftp.info.apple.com//Apple.Support.Area/Apple.Software.Updates/US/
  29.   Macintosh/Display_and_Peripheral/CD-ROM_Software_5.1.7.sea.hqx>
  30.  
  31. Support:
  32. Please feel free to send me email describing any problems you might be having. Many problems can be traced to incompatibilites between 3rd party drives/drivers and the standard set by Apple brand drives. Try running the AppleCD Audio Player; if it doesnﾕt work, then your problem is probably not mine. You do not need to register to ask questions.
  33.  
  34. The modules:
  35. Holding the command key down and clicking on any of the modules will present a menu with configuration options for that module; at a minimum this will allow you to select which CD ROM drive the module will be controlling.
  36.  
  37. The free modules:
  38. CD Omni GH is the crown jewel of Audio Strip. Not only can it play, pause, stop, and set the sound level, but it can also auto-play on insert, auto-eject on completion, auto-repeat on completion, save a default sound level, and play track programs either random, entered into the AppleCD Audio Player (version 2 and above) or both.
  39.   Depending on the state of the CD drive, the module will show one of three icons: an ﾒXﾓ icon indicates that there isn't an audio CD in the drive; a triangle icon indicates that there is an audio CD in the drive and it is either stopped or paused; while a double rectangle icon means that an audio CD is currently playing.
  40.   One of the preference settings (command click on the module to access) is ﾒUse Programﾓ. Selecting this item tells the module to look in the ﾒCD Remote Programsﾓ file for a track program, a series/ordering of tracks to play for a given CD; with this opton set and a program available, the module will try to play the tracks in that order, ignoring any tracks not in the program. Another way to play programs is to select the ﾒPlay Tracks Randomlyﾓ option which will automatically generate a track program by playing all the tracks on the disk (or in the AppleCD program) in random order. Using a standalone CD controller or the Play, Stop, Next, Last, FFwd, or FRev will disrupt programmatic playback; holding the shift key while clicking on the module will overide the current setting of ﾒUse Programﾓ and ﾒPlay Tracks Randomlyﾓ.
  41.                                           Action
  42. State           Quickly Click on Icon   Click on Icon and hold
  43. (X)                                                            |                                    none                                                    |  menu with put away (eject) 
  44. --------------------------------------------------------------------------------
  45. (>)                                                            |    start playing or unpause    |    track menu+continue+stop+put away
  46. --------------------------------------------------------------------------------
  47. (||)                                                     |                                    pause                                                |    track menu+pause+stop+put away
  48. --------------------------------------------------------------------------------
  49. Use Program +                    |                    start program or                    |program menu+continue+stop+put away
  50. Program+    (>)                  |     unpause program                        |
  51. --------------------------------------------------------------------------------
  52. Don't Use Program+|                            same as above                        |                                same as above
  53. Program+Shift+                |        (shift overides ﾒUse                |
  54. (>)                                                            |                Programﾓ Setting)                    |
  55. -----------------------------------------------------------------------------------------------
  56. No Program + Shift|        if stopped play only                |        track menu, if track selected
  57. + (>)                                                    |                    1st track                                                |            play only 1 track then stop
  58.  
  59. Holding down the ﾒctrlﾓ key and clicking will display a graphical sound level menu identical to the one used by CD Volume GH (described below). 
  60.  
  61. CD Volume GH is used to control the sound level of audio CD playbackﾑhow loud it is. This presupposes that your CD ROM drive supports software control of sound level; drives such as the Apple CD SC do not, and this module will not even load if such a drive is the only one present. 
  62.   Clicking and holding on this module's icon (up and down triangles) will bring up a graphical menu of sound levels, moving the mouse up and down this menu will dynamically change the relative loudness of audio playbackﾑ65 possible settings. If you release the mouse outside the menu, the sound level will return to its previous value.
  63.   The preference menu for this module allows you to save the current setting as a default sound level for the next time you restart your systemﾑagain the preference menu is accessed by holding down the command key (clover leaf) and clicking and holding on the module.
  64.  
  65. Other free modules:
  66.                                              Action
  67. Module             Click and Release         Click and hold          
  68. Pause (||)                         |  if playing, pause      |           none
  69. --------------------------------------------------------------------------------
  70. Stop (□)                           | if playing/paused, stop |           none
  71. --------------------------------------------------------------------------------
  72. Play     (>)                             |start playing from begin |track menu (shift to play only 1)
  73. --------------------------------------------------------------------------------
  74. Eject (^)                                            | Put Away (eject) drive  |           none
  75. --------------------------------------------------------------------------------
  76.  
  77. The encrypted modules:
  78. CD Omni GH 2 is an enhanced version of the omni module and as such is the best module in Audio Strip. It is a general purpose display module which in addition to all the functions of the Omni module alse keeps track of the current track, sound level and time of a playing or paused CD. Any of 4 times can be displayed in the lower right portion of the module: left in track (default), left in whole CD, into track, into whole CD. If you are playing a program or randomized program, the time left in the progam is substituted for the time left in the CD, and the time into the program is substituted for the time into the CD. If there is no playing or paused audio CD in the drive, the time and track displays are replaced with hyphens (--). 
  79.  
  80. The current playing status is indicated by a mini-icon in the lower left hand corner of the display. The current track is displayed in the upper left corner, while the current sound level is displayed (if there is room) as a series of filled or unfilled squares over the time display. The sound level will not be displayed if your drive does not support software volume control.
  81.  
  82. Clicking on the module brings up an extended preference menu allowing the selecting of the same options used in the omni module as well as which time to display, and how often the time should be updated (I prefer every 2 seconds). 
  83.  
  84.  
  85. Other encrypted modules:
  86.                                              Action
  87. Module               Click and Release          Click and hold      
  88. Next( >>| )        |if playing, play next track| play track after that and so on
  89. --------------------------------------------------------------------------------
  90. Last( |<< )        |if playing track start over| play track before this one
  91. --------------------------------------------------------------------------------
  92. FFwd ( |> )        |start playing really fast  | keep playing fast
  93. --------------------------------------------------------------------------------
  94. FRev( <| )         |start playing fast backward| keep playing fast backward
  95. --------------------------------------------------------------------------------
  96.  
  97. Resources:
  98. Module     Memory      CPU Time        Screen Size
  99. Omni        | 16.2K |  some                |  21 pixels wide
  100. -----------------------------------------------------------
  101. Omni PPC    | 23.6K |  some                |  21 
  102. ----------------------------------------------------------- 
  103. Omni 2      | 23.1  |  a little more       |  54 (Geneva 9)
  104. -----------------------------------------------------------
  105. Omni 2 PPC  | 34.1  |  ""                  |  54 (Geneva 9)
  106. ----------------------------------------------------------- 
  107. Volume      |  6.8  |  virtually none      |  21
  108. -----------------------------------------------------------
  109. Play        |  6.5  |  virtually none      |  21
  110. -----------------------------------------------------------
  111. Stop        |  6.1  |  virtually none      |  21
  112. -----------------------------------------------------------
  113. FFwd                             |  5.5  |  virtually none      |  21
  114. -----------------------------------------------------------
  115. FRev                             |  5.5  |  virtually none      |  21
  116. -----------------------------------------------------------
  117. Last        |  5.4  |  virtually none      |  21
  118. -----------------------------------------------------------
  119. Next                    |  5.2  |  virtually none      |  21
  120. -----------------------------------------------------------
  121. Eject                      |  4.4  |  virtually none      |  21
  122. -----------------------------------------------------------
  123. Pause       |  4.1  |  virtually none      |  21
  124. -----------------------------------------------------------
  125.  
  126.  
  127. Localization:
  128. I understand and hope that many of my users are in far away corners of the world (and for all I know beyond), and that file names and special characters might be different than here in the United States. Therefore, here are some things you can change with a little use of ResEdit (as always, ResEdit is powerful and potentially destructive, so know what you are doing, and be careful) to make these modules at home:
  129.  
  130. File name: CD Remote Programs
  131. This file is where the US version of the AppleCD Audio Player saves its lists of track names and track programs. If your version of the player uses a different filename, you will have to open CD Omni GH and CD Play GH with ResEdit and change the 2nd item of STR# resource 256 to the name your player uses. You can determine the proper name by running the AppleCD Audio Player, changing a track name, closing the player, going to the ﾒPreferencesﾓ folder inside your ﾒSystem Folderﾓ, choosing ﾒView by Dateﾓ, and making a note of the 2nd most recently modified file (the first most recently should be the preferences for the player itself.)
  132.  
  133. I happen to know that the filename used in France is ﾒProgrammes CDﾓ, and that the German name is ﾒCD Verzeichnisﾓ. I know this because users e-mailed me this info. Hint. Hint.
  134.  
  135. No valid time indicator:
  136. The Time module indicates a stopped or non-existent audio CD by replacing track numbers and times with pairs of hyphens ﾒ--ﾓ, if you have a different symbol for indicating this, open up CD Time GH and change the 31st item of STR# resource 256 to whatever is appropriate (2 bytes long please).
  137.  
  138. Menu items:
  139. The text for all the menus as well as balloon help strings are stored in the STR# resource 256 in all the modules. 
  140.  
  141. Icons:
  142. The graphics for each button are stored in ics#, ics4, and ics8 resources. Make sure that you don't enlarge the rectangle enclosing the icons used by the Omni 2 module. 
  143.  
  144. Warrantee:
  145. There is none. Any damage caused by using this software is the responsibility & problem of the user. If you have paid your fee, I will consider refunding the amount you paid; but this is entirely at my discretion.
  146.  
  147. Report Bugs/ Feature Requests:
  148. Internet: grhowes@kagi.com
  149. (My actual address is grhowes@tiac.net, but the nice people at Kagi have a forewarding service, so my email gets sent to where I am now.)
  150.  
  151. Look for:
  152.  My AppleScript Audio CD extension: AudioCDgh.
  153.  My standalone CD Player: Remote Remote GH, scriptable & control CDs over AppleTalk
  154.  My home page: http://www.tiac.net/users/grhowes/
  155.  
  156. Written In:
  157. C using Codewarrior 8.
  158.  
  159. Thanks to:
  160.  My beta testers especially Troy Gaul who nagged me into the Omni module.
  161.  
  162.  Leonard Roesenthol for pointing out the flicker free beauty of the srcCopy text mode.
  163.  
  164.  The good folks of St. Pious the X Grade School in Billings, MT, where I went to 1st through 3rd grade. I hope you are still in business.
  165.  
  166.  Eric Clapton for doing the most beautiful cover of ﾒSwing Low Sweet Chariotﾓ, available on his ﾒTimepiecesﾓ compilation album..
  167.